#include

Доступность

Flash Player 4.

Синтаксис

#include "[path] filename.as"

Замечание: Не нужно ставить точку с запятой (;) в конце строки, содержащей выражение #include.

Параметры

[path] filename.as Имя файла и необязательный путь к скрипту, добавляемому к панели Actions или к текущему скрипту; рекомендуемое расширение файла - .as.

Возвращает

Ничего.

Описание

Директива компилятора: включает содержание указанного файла, как будто комманды в файле являются частью вызываемого скрипта. Директива #include вызывается во время компиляции. Следовательно, если вы сделали какие-либо изменения во внешнем файле, то вы должны сохранить этот файл и перекомпилировать все файлы FLA, которые используют его.

Если вы используете кнопку Проверки Синтаксиса (Check Syntax) для скрипта, содержащего выражение #include, то также будет проверен и синтаксис включенных файлов.

Вы можете использовать #include в файлах FLA и во внешних файлах скриптов, но не в файлах классов ActionScript 2.0.

Вы можете не указывать путь, а можете указать относительный или абсолютный путь для включаемого файла. Если вы не указываете путь, то файл AS должен быть в одном из следующих мест:

Для указания относительного пути к файлу AS, используйте одну точку (.) при обозначении текущей папки, две точки (..) при обозначении вышестоящего каталога и левую косую черту (/) при обозначении подкаталогов. Смотрите раздел с примерами, следующий далее.

Для указания абсолютного пути к файлу AS, используйте формат, поддерживаемый вашей платформой (Macintosh или Windows). Смотрите раздел с примерами, следующий далее. (Такое использование не рекомендуется, потому что оно требует, чтобы структура каталогов была одинаковой на каждом компьютере, который вы используете для компиляции скрипта.)

Замечание: Если вы размещаете файлы в каталоге First Run/Include или в глобальной директории для вложений, то сделайте резервные копии этих файлов. Если вам когда-либо нужно будет демонтировать или повторно установить Flash, то эти каталоги могут быть удалены и перезаписаны.

Пример

Следующие примеры показывают различные способы указания путей для файла, включаемого в ваш скрипт:

// Помните, что выражение #include не может оканчиваться точкой с запятой (;)
// файл AS располагается в том же каталоге, что и файл FLA или скрипт
// или в глобальном каталоге для вложений или в каталоге First Run/Include
#include "init_script.as" 

// файл AS располагается в подкаталоге одного из вышеупомянутых каталогов
// Подкаталог назван "FLA_includes"
#include "FLA_includes/init_script.as"

// файл AS располагается в каталоге того же уровня, что и вышеупомянутые каталоги
// Каталог назван "ALL_includes"
#include "../ALL_includes/init_script.as"

// файл AS указан абсолютным путем в Windows
// Не забывайте, что использовать надо левые косые черты, а не обратные
#include "C:/Flash_scripts/init_script.as"

// файл AS указан абсолютным путем в Macintosh
#include "Mac HD:Flash_scripts:init_script.as"

См. также

import